home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / picsw101.lzh / PICSW101.DOC < prev    next >
Text File  |  1993-03-10  |  24KB  |  549 lines
  1. PicSwitch v1.0.1
  2. Graphics File Viewer / Printer
  3. (c)1993 John Brochu for Advanced Software
  4.  
  5. ---------------------------------------------------------------------------
  6.  
  7.  
  8. This is the long-awaited update to PicSwitch, the award-winning graphics
  9. utility from Advanced Software.  This version actually bears no
  10. resemblance to its predecessor, being totally rewritten with a standard
  11. GEM interface with enhancements.  Many new input formats have been added,
  12. as well as a new 'Adjustments' control panel, windowed displays, and
  13. much-enhanced printing support for Epson 9-pin, 24-pin and HP LaserJet
  14. compatibles.
  15.  
  16. This will also, unfortunately, be the final update, since I have retired
  17. from the Atari platform and switched to the Mac.  This version, originally
  18. intended as a commercial release, is a thank you to all the people who
  19. have paid their shareware fee for PicSwitch 0.7, and other shareware
  20. products released since 1985, including ProCalc and Deluxe SlideShow (you
  21. know who you are).  For those who haven't yet paid, and find this version
  22. of use, you are asked to send a very modest $10. payment to the address at
  23. the end of this document.  If I get enough payments, I may be tempted to
  24. come back!
  25.  
  26. It is important to note that this version is more of a display and print
  27. utility, rather than a conversion utility.  The ONLY output format
  28. supported in this release is IMG, and only in monochrome.  But the display
  29. and printing support are very complete and robust.  There are many types
  30. of dithering, for best output on monochrome displays, fully adjustable
  31. brightness, contrast, and scaling, and color optimization for excellent
  32. color rendition in any of the ST video modes.  Support is also provided
  33. for the Crazy Dots video card in 256-color mode (highly recommended!).
  34. Although options exist for all the TT video modes, this has not been
  35. tested.
  36.  
  37. Printing support is also excellent.  Printers supported are Epson 9 and 24
  38. pin printers and compatibles, and HP LaserJet compatibles.  Many options
  39. are provided for dithering, scaling, resolution, and brightness
  40. enhancement.  If you are using a LaserJet, you also have an option (called
  41. tiling) to print as many images as possible on a single page, for
  42. cataloging purposes.  There is also support for Outburst!, a printer
  43. speedup utility by Frank Pawlowski, to dramatically speed up printouts for
  44. many printers.
  45.  
  46. Following is a list of all formats supported by this release:
  47.  
  48. NeoChrome [NEO]
  49. Degas [PI1-3]
  50. Degas Elite [PC1-3]
  51. Tiny [TNY, TN1-3]
  52. Art Director [ART]
  53. Spectrum 512 [SPC, SPU]
  54. Prism Paint [PNT]
  55. GEM IMG [IMG]
  56. Atari Image Manager [IM]
  57. Compuserve GIF [GIF]
  58. Compuserve RLE [RLE]
  59. PC Paintbrush (Monochrome, 16-color, 256-color) [PCX]
  60. Amiga IFF (1-5 planes, HAM) [IFF]
  61. MacPaint [MAC]
  62. Mac StartupScreen [MAS]
  63. Atari Portfolio Graphics File [PGF, PGC]
  64. Atari 8-bit Koala [KOA]
  65. Atari 8-bit MicroPainter [MPT]
  66. Atari 8-bit Graphics 8 [GR8]
  67. Atari 8-bit Graphics 9 [GR9]
  68.  
  69.  
  70.  
  71. ABOUT THE INTERFACE
  72. -------------------
  73.  
  74. PicSwitch was designed from the ground up to be easy and intuitive to
  75. learn and use.  Finding the GEM interface to be too restricting and in
  76. some ways outdated, I have written a library of interface enhancements,
  77. familiar to Mac users, to improve the user interface.  You will find new
  78. radio buttons, checkboxes, popup menus, sliders, and other graphical
  79. elements, as well as internally an optimized memory manager.
  80.  
  81.  
  82.  
  83. ABOUT MEMORY USAGE
  84. ------------------
  85.  
  86. To more effectively manage memory, PicSwitch uses custom memory-management
  87. routines using a system similar to the Macintosh's Memory Manager.  The
  88. benefit is that memory is much more efficiently managed, and the user sees
  89. fewer "Not enough memory" messages.  The amount of memory reserved by
  90. PicSwitch's memory manager when the program is run can be controlled from
  91. the SET PREFERENCES dialog.  This retains compatibility with MultiTOS and
  92. other multi-tasking extensions to TOS.
  93.  
  94.  
  95.  
  96. INTERNAL OPERATIONS
  97. -------------------
  98.  
  99. Internally, PicSwitch translates each image to its own bitmap and
  100. color-palette format.  These formats were chosen to allow both maximum
  101. image and color resolution, and maximum processing speed.  The bitmap
  102. format is packed-pixel format, with 1, 2, 4, 8, or 16 bits per pixel,
  103. while the color palette is stored as 8-bits per RGB color, 32-bits per
  104. palette color.  All imaging routines are fully optimized and hand-coded in
  105. assembly for maximum possible speed.  Color displays are calculated using
  106. a closest-match process that first determines the 'n' most-used colors in
  107. the image, where 'n' is the number of colors available in the selected
  108. display mode, then matches each image color to its closest available
  109. palette color.  The number of colors to use can be limited, as can the
  110. fineness or granularity of the color palette, using the control panel.
  111. You can also choose to display color images as gray-scale images, with or
  112. without dithering.  For monochrome displays, you have many dithering
  113. options available to achieve a high-quality display, true to the original
  114. image.
  115.  
  116.  
  117.  
  118. ABOUT THE MENUS
  119. ---------------
  120.  
  121. About PicSwitch...
  122. This brings up the title dialog box that provides copyright and version
  123. information, memory status, and system information.
  124.  
  125.  
  126. FILE MENU
  127.  
  128. New (not implemented)
  129.  
  130. Open...
  131. Brings up the file selector to select a file for viewing.  Only one file
  132. can be viewed at a time.  If an image is currently in memory, it will be
  133. replaced by the selected image.  Only files that have a recognized file
  134. extender will be loaded (see the list above).  Some file types are also
  135. verified to make sure they are of the correct type, where possible.  In
  136. some cases this cannot be done, so be careful in naming your files,
  137. loading a file that has an incorrect extender may crash the system.
  138.  
  139. Close
  140. Closes the top window, whether a tools or display window, and moves the
  141. next window down to the top.  Closing the display window does NOT remove
  142. the image from memory, all it does is close the window.  You can reopen
  143. the window at any time.
  144.  
  145. Save / Save as...
  146. This allows you to save the currently displayed monochrome image as an IMG
  147. file.  This is the only format supported at this time.  If a color display
  148. is in use, this option is disabled (sorry!).  This does allow you to
  149. import color images, render them in black & white, and export them for use
  150. in desktop publishing.
  151.  
  152. Print...
  153. This brings up the PRINT IMAGE dialog box.  From here you can select the
  154. printer type (9-pin / 24-pin / LJII), resolution (varies depending on the
  155. printer selected), draft / final print (available only for certain
  156. resolutions), rendering (dithering), scaling, lightening, and when /
  157. whether you want a page ejected.  See 'The PRINT IMAGE Dialog' below.
  158.  
  159. Quit
  160. Quit PicSwitch
  161.  
  162.  
  163. OPTIONS MENU
  164.  
  165. Adjust
  166. Same as pressing the 'Adjust' button in the control panel.
  167.  
  168. Histogram...
  169. Brings up the GRAY-SCALE HISTOGRAM dialog box, allowing you to examine the
  170. gray-scale content in the current image, and adjust the brightness and
  171. contrast controls indirectly by setting the low and high clipping
  172. thresholds.  See 'The GRAY-SCALE HISTOGRAM Dialog' below.
  173.  
  174. Image Aspect Ratio...
  175. Brings up the ASPECT RATIO dialog box, allowing you to change the default
  176. pixel aspect ratio for the current image.  All images are initially set
  177. correctly if they contain valid pixel aspect ratio information.  Some do
  178. not contain it at all, so you may have to set this manually if the image
  179. appears to be 'stretched' in either direction.  You will then have to
  180. click on 'Adjust' to make the changes visible.
  181.  
  182. Preferences...
  183. Brings up the SET PREFERENCES dialog box, allowing you to set up certain
  184. options pertaining to the operation of PicSwitch.  See 'The SET
  185. PREFERENCES Dialog' below.
  186.  
  187.  
  188. WINDOWS MENU
  189.  
  190. Adjustments
  191. Opens the ADJUSTMENTS control panel.  If it is already open, it is brought
  192. to the top.  See 'The ADJUSTMENTS Control Panel' below.
  193.  
  194. Statistics
  195. Opens the STATISTICS window, showing the file name, type, and resolution
  196. and color information.  If it is already open, it is brought to